home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games Extra 1996 June / Amiga Games Extra 1996 #6.iso / userbox / publicdomain / gnutar / readme.amiga < prev    next >
Text File  |  1996-03-11  |  10KB  |  203 lines
  1.  
  2.  ===========================================================================
  3.  = GNUTar Amiga Port of V1.11.2 (originally from 25 Mar 1993)              =
  4.  = ----------------------------------------------------------------------- =
  5.  = Amiga Port release version: V1.2                                        =
  6.  = Release Date:               11.03.1996                                  =
  7.  ===========================================================================
  8.  
  9.  1995-96 rework, SAS/C V6.56 recompilation, GNUTar V1.11+ adaption,
  10.  and 68030/040 version by Andreas R. Kleinert (email below)
  11.  
  12.  Original port of GNUTar V1.09 done by Ed Berger (email below)
  13.  
  14.  
  15.                        *** Why ? ***
  16.  
  17.  When extracting TAR archives on the AMIGA there always had been a problem:
  18.  the only available GNUTar port was hard to find and if you got it
  19.  finally, it was quite old and just unoptimized for higher 68k CPUs.
  20.  
  21.  On the other hand, a simple recompilation wasn't easy for most people,
  22.  since the GNU-C (GCC) Compiler isn't very widely used and adaptions
  23.  for other compilers aren't that easy (as I finally found out ;-)
  24.  
  25.  
  26.                        *** How ? ***
  27.  
  28.  My first step to solve this problem was porting the nice, small and
  29.  handy "DeTar" utility from MS-DOS to Amiga.
  30.  The usage was really simple and easy, since you'd just had to call
  31.  "DeTar [archive]" and the whole archive would have been unpacked.
  32.  While searching for Bugs within DeTar (thus using the available GNUTar
  33.  port) I decided to port GNUTar directly (since there actually appeared
  34.  some effects I thought of as bugs of DeTar, but as well possibly
  35.  could have been bugs of the Amiga version of GNUTar ;-)
  36.  
  37.  So there suddenly was a new SAS/C V6.55 port of GNUTar for the Amiga,
  38.  which wasn't perfect at all, but was thought as a base for further
  39.  actions by other people (or me :-)
  40.  
  41.  People greatly reacted on this new GNUTar port and reported bugs
  42.  as well as request for also creating updates, which make use of
  43.  features of newer GNUTar versions.
  44.  
  45.  So I dropped the old V1.09 sources ported by Ed Berger and began
  46.  re-porting V1.11.2 (a beta test release) to the Amiga, still using
  47.  some of the old port stubs (but GCC stuff became useless now).
  48.  
  49.  
  50.                        *** Next ? ***
  51.  
  52.  Since V1.11.2 was a beta test release and still isn't the newest
  53.  available version of GNUTar, you may expect newer versions soon.
  54.  
  55.  
  56.                        *** Details ? ***
  57.  
  58.  Before I add the original "documentation" of Ed Berger, please take
  59.  a look at these notes:
  60.  
  61.        - some of the defines and/or functions, which hadn't be present
  62.          for the GCC are actually available for SAS/C and vice versa.
  63.          So there are still some dummy-functions or (hopefully)
  64.          equivalent replacements for such things.
  65.          See the files "sas_amiga.c" and "sas_amiga2.c" for code-replacements
  66.          and the headers within "sasinclude/" and "sasinclude/sys/"
  67.          for additional defines.
  68.          I went this way, since this prevented me from changing _anything_
  69.          within the orginal source.
  70.          The only thing to be done was setting definitions and compiler
  71.          options in the best way and then fill in the missing parts
  72.          (sounds easier, than it was %-)
  73.        - ahm...well: while compiling there occured several problems
  74.          (warnings, missing functions, which had to be substituted
  75.           by dummies, etc.). So remember: it works, but there's really
  76.           no guarantee for anything !
  77.  
  78.  
  79.                        *** Who ? ***
  80.  
  81.  Andreas R. Kleinert, Fido   2:2457/435.10
  82.                       UseNet Andreas_Kleinert@superview.ftn.sub.org
  83.                              Andreas_Kleinert@t-online.de
  84.  
  85.  
  86.                        *** History ? ***
  87.  
  88.  Revisions:
  89.  
  90.   V1.2   (11.03.1996): - fully recompiled with SAS/C V6.56
  91.                        - added Osma Ahvenlampi's fix for the
  92.                          1.0.2 protection bit problem (archive
  93.                          appeared at "util/shell" on AmiNet).
  94.  
  95.                          I adapted it to the new 1.11.2 source and
  96.                          changed the way binding it into the source
  97.                          (fully via REDEFINES.WTH, no changes to tar.h,
  98.                           thus had to call lstat() from sas_amiga.c instead
  99.                           of stat() to avoid recursion).
  100.  
  101.                          Here's what Osma originally said:
  102.  
  103.                          'This patch makes an attempt to translate Amiga
  104.                          protection bits to the closest UNIX equivalents.
  105.                          When extracting UNIX archives, it also sets the
  106.                          group and world bits as specified in the archive,
  107.                          for those with multiuser filesystems.
  108.                          When creating an archive, these bits are
  109.                          unfortunately not retained, since SAS/C's stat()
  110.                          function ignores them.'
  111.                          (-> Osma.Ahvenlampi@hut.fi)
  112.  
  113.   V1.1   (16.09.1995): - did change version counting: it's too
  114.                          confusing the old way.
  115.                          The original version number of the GNUTar
  116.                          we base on, still is mentioned at the top of
  117.                          this documentation
  118.                        - completely redid the port: we now do use
  119.                          the original GNUTar 1.11.2 (a so-called beta
  120.                          test release) instead of the AMIGA/GCC-adapted
  121.                          GNUTar 1.09.
  122.                          Kind of an update: I simply copied the new
  123.                          source over the old one, changed the compiler
  124.                          settings, added some more include files and
  125.                          resolved all inconsistencies - of course
  126.                          *without directly changing any piece* of
  127.                          the original GNU C-Sources!
  128.                          (-> Regis Rampnoux, ...)
  129.                        - README and GNU-License (COPYING) also have been
  130.                          updated - old GNU license replaced by newer one.
  131.                          There was no update to Tar.man - sorry
  132.                          (but I added a specific note to it, to cover this).
  133.                        - removed some GCC-addon's, which Ed Berger had
  134.                          designed for V1.09, but which won't work with
  135.                          V1.11.2 any longer. You may take them from
  136.                          Amiga release V1.0.2 (23.07.1995) and adapt them
  137.                          - if you like or need them for GCC.
  138.                        - again did change chmod() - there was a mysterious
  139.                          effect, which caused it to be restored to the
  140.                          old, wrong way
  141.                        - replaced 68030 and 68040 versions by a combined
  142.                          68030/040 version, since SAS/C does not
  143.                          actually make any differences for our code.
  144.  
  145.   V1.0.2 (23.07.1995): - hey, found out that the base version actually
  146.                          had been released as V1.09.
  147.                          Added note to this readme.
  148.                        - two people complained, that my GNUTar port did
  149.                          not set correct flags out of "hsparwed" for the
  150.                          amiga files when extracting from archives, as the
  151.                          old GNUTar did.
  152.                          Well, foudn out, that the old one just _did_ _not_
  153.                          _change_ the default flags (always "rwed") and
  154.                          we're now just doing the same, since the mode
  155.                          field of unix TARs is either broken ("hpw" always
  156.                          after conversion Unix->Amiga) or SAS/C's definition
  157.                          for the S_IREAD (and so on) flags aren't compatible.
  158.                          Now "rwed" will be set always.
  159.                          You may change this behaviour within "sas_chmod()"
  160.                          in "sas_amiga.c".
  161.                          (-> bussjaeg@informatik.tu-muenchen.de;
  162.                           Christian Bauernfeind,
  163.                           crisbf@theorie3.physik.uni-erlangen.de)
  164.                        - mkdir(), which needs only one argument with SAS/C
  165.                          had been called with two (got warnings).
  166.                          Now we're doing this:
  167.                            #define mkdir(x, y) mkdir(x)
  168.                          Well, it works ;-)
  169.  
  170.   V1.0.1 (07.07.1995): - re-compiled with SAS/C V6.55
  171.                        - added 68040 version
  172.                        - removed object files from archive due to size
  173.                        - fixed bug note in documentation; was not a bug
  174.                          (-> David Balazic, david.balazic@uni-mb.si)
  175.  
  176.   V1.00  (23.03.1995): - first release, compiled with SAS/C V6.51
  177.  
  178.  
  179. ****************************************************************************
  180.  
  181. Following is, what Ed Berger originally wrote in "readme.1st"
  182. for V1.09. As with Amiga release V1.1 (GNUTar V1.11.2, first port release)
  183. I re-switched to the original GNU-sources in combination with some
  184. of the old code-workarounds:
  185. ----------------------------------------------------------------------------
  186.  
  187. I was looking for a tar program for the Amiga, since the gcc distribution,
  188. and minix distribution files are often in this format.  Tarsplit from an
  189. old fish disk was not sufficient.  I kept hearing about gnu-tar, but
  190. never saw it archived anywhere, until now.
  191.  
  192. Since I was not able to find gnu-tar, under any separate archive on the
  193. fish disks, or on my favorite ftp-sites, I pulled this out of the UUCP
  194. distribution from uunet.  The binary and man page were on disk 2, and
  195. the source files were on disk 3.  I hope that I didn't miss anything
  196. important.  I apologize for any inconvenience this may cause.  If in doubt
  197. go back to the UUCP distribution.
  198.  
  199. -Ed Berger
  200.  eb15@andrew.cmu.edu
  201.  
  202. ****************************************************************************
  203.